先说结论:npm install 报错,先看是哪一句,别急着删 node_modules 装依赖是开发里最容易被一句话卡住的事。npm install 一跑,红的绿的刷一屏,最后停在某个报错上,很多人第一反应是「删了 node_modules 重装」「换 yarn」「重装 node」——这些动作偶尔能撞对,但大部分时候是浪费时间,因为不同的报错,根因完全不一样,修法也不同。 这篇就把 npm install 最常见的几类报错拆开,告诉你每一句报错对应查什么、怎么修。都是我踩过或者看着同事踩过的坑,按「花多少时间、多大概率解决」排了序。 先说清楚适用场景:这篇针对的是普通前端/Node 项目装依赖报错,不是公司内部私有源、monorepo 花式 workspaces 那种需要团队基建配合的场景。 三类报错,先对号入座 npm install 报错虽然五花八门,但归类下来主要就三种,先判断你属于哪一种,方向就对了大半: 第一类:依赖冲突(ERESOLVE)。报错里出现 ERESOLVE、unable to resolve dependency tree、peer dependency 这类.... 有更新 npm install 报错怎么办:先看 ERESOLVE、EACCES 还是 node-gyp,再对症下药(2026) AI 工具